


BetaWaorks 
IBM Integration Bus 


Broker Administration using the 
Web Administration Interface 


september, 2013 


Hands-on lab built at product 
code level version 9.0.0.0 
Toolkit iF ix 1 


IBM Integration Bus V9.0 Workshop september 2013 


a ea BL a ©) Be) WO) Gd | |) ee ene ene ne en neta on neon Pome ene eon cnn eee ee ee ee 3 
| oe =| 67 ©) =) 0¢21 ¢=11(0) 9 nee en ee eee Error! Bookmark not defined. 
Ie MeCSet IBQNOD E SCCUMTY suds cuniientounietiavavrantwaa nine yannitas aus towivanaue wala tvawndndauiiis lated nlvia nNaLeaaeekeuadine 3 
2. PREPARE THE IB9NODE APPLICATIONS ......... ce cccceceseeeseeeeeeeeeeeeeeseeesaeenes 4 
3. AFIRST LOOK AT THE WEB ADMIN INTERFACE (NO SECURITY)............... 14 
4. CONFIGURE ROLE-BASED SECURITY FOR WEB USERG............... eee 18 
Ad. JACIVAaTe-SECURILY TOMIBINOD Exide danas ee Nie ie ene iene ee 19 
4.2 Define the MQ authorities for the WED USESS.............cccccccccsseesseceeeeeeeceesseeceeeceeeeeeesseeeeseeesaaeaseeeeeeeeaas 21 
4.3 Define the MQ authorities Manually (OPtioNal) ...............ccccccccccceeeeeceeseeeeeseseeececeeeeeeeeeeesseseaeaeaeseeeeeess 22 
4.4 Define the web users for IBQNODE. .............ccccccceccceceeeececceeecceceeeecescaeeeeseuueeesaeaecesseaeceessaeeeeesaueeessanes 27 
5. USING THE WEB ADMIN INTERFACE WITH SECURITY............. ec eeeee eens 28 
5.1. The web admin interface for a read-Only USEF ............cccccccccccseseeeeeccaueeseceeeeaeeeeeeeesseaeeeessaaeeeeeessaaeeeees 28 
5.2 The Web Admin interface for a user with UPAate ACCESS............cccccsseeceeceeeeeeeeeeeeeeseeeeeesuaeeeeesegeeesaees 33 
6. EXPLORING THE WEB ADMIN FLOW STATISTICS FACILITIES..........000000.0. 36 
6.1 Investigate the statistics function in the web adMiIn Interface ..............cccccceecceceeeeceeeeeeeeeesaeeeeseeeeeaes 36 
6.2 Using the Web Admin interface to show running flow StatiStiCS ..............ccccccccsseceeeeeeeeesseeeeeseeeeeesaees 48 
6.3 Create and use a policy to limit flow throUQhpUt ............ cee cece ec eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaeeeeeeeaaaeeeeeesaaees 59 
Page 2 Web administration Version 9.0.0.0.1 


Provided by IBM BetaWorks 


IBM Integration Bus V9.0 Workshop september 2013 


1. Introduction 


WebSphere Message Broker Version 8 and 8.0.0.1 introduced the web browser administration tools, and 
IBM Integration Bus Version 9 has made significant improvements in this function. The Web User 
Interface (known in this document as the Web UI) provides the following capabilities: 


Ability to define web users (with associated userid/password authentication) 

Ability to allow defined users to perform password and profile maintenance 

Ability to define appropriate levels of authorization for authenticated users (role-based security) 
Ability to perform update actions against deployed resources (start, stop, etc.) 

Ability to view trace and log files through the Web UI 

Ability to view and update broker policy documents 

Ability to create pattern instances and deploy direct to a broker (limited function at the moment) 
Enhanced function specifically for the Record and Replay item, with associated authorization 
profiles 


This lab will demonstrate some of these points, with the exception of the Record/Replay topic. This is the 
subject of a separate lab. 


This lab has been updated for IBM Integration Bus version 9.0, and specifically includes topics 
covering flow statistics and policy-controlled workload management. 


1.1 Reset IB9NODE security 


The first part of this lab assumes that security has not been activated for IB9QNODE. If security has been 
activated on your system, deactivate it now: 


Set security off with the following commands in an Integration Command Console: 
mqsistop IB9YNODE 


mqsichangebroker IB9YNODE -s inactive 


mqsistart IB9YNODE 
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2. Prepare the IBQNODE applications 


So that the Web UI has some artefacts on which to operate, you will first deploy some application 
artefacts. 


1. ‘If not already open, start the Integration Bus Explorer (MQ Explorer) from the desktop icon. 
We will be using the WorkloadManagement integration server (known as an execution group in earlier 


versions of WebSphere Message Broker). If you do not have the WorkloadManagement integration server, 
right-click on IBQNODE and select New > Integration Server, and name it WorkloadManagement (correct 














case). 
dp IBM WebSphere MQ Explorer (Installation1) 
File Edit Window Help 
[El IBM WebSphere MC : 
© om Bee dala Integration Node II 
_ f-ARl iesqmer 
_ HG IB9QMGR2 eae ner ser ree 
(=> Queue Manager Clusters 
(> JMS Administered Objects Connection Status 
: ve (= Managed File Transfer Connection Type 
~~ (> Service Definition Repositories ——— 
Flee Integration Nodes Port 
| lel [EE Queue Manager 
oS ee IY ricocaton sever. | 
Click OK. 
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2. If you have done the WorkloadManagement labs, you may already have resources deployed in this server. 
We want to deploy fresh copies of the message flows to the integration server, so we will delete any current 
resources. 


In the Integration Nodes pane, right click the WorkloadManagement integration server and select Delete > 
All Flows and Resources. 


dp IBM WebSphere MQ Explorer (Installation1) 





Integration Server Worklo 






ES IBM WebSphere MQ 


Ae Queue Managers 


Properties QuickView: 







Peery Long iption 
Short Description 
Queues used 



















“ [= Telemetry leer Hace 
2 - “= Listeners Service Trace 
ok Services Resource Statistics Active 


Flow Debug Port 

Process ID 

Content Based Filtering 
Global Cache Components 


‘as (= Security Policies 
Elegy! IBSQMGR2 
[=> Queue Manager Clusters 


[= IMS Administered Objects 


e+ Managed File Transfer 





~~ Service Definition Repositories 
Foes Integration Nodes 





| = ze 
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3. Still in the Integration Bus Explorer (not the toolkit), deploy the barfiles for testing the Web UI interface. 
First, import the BAR files into the Explorer. 


Right-click Bar Files, select New > Bar Folder. 


dp IBM WebSphere MQ Explorer (Installation1) 





In Bar Folder name, type in WMLStats. 
Click Finish. 


4 Bar Folder 


Bar Folder 
Create a new Bar Folder 
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4. Right click WLMStats and select Import Bar Files. 


September 2013 





dp IBM WebSphere MQ Explorer (Installation1) 


File Edit Window Help 








| El-Gi IBM WebSphere MQ 
Fl-(= Queue Managers 
[=> Queue Manager Clusters 


~~ Service Definition Repositories 
Fld Integration Nodes 
|) gs default 

: Ege WorkLoadManagement 


Dela Resource Managers 
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EE ciel) 








Bar Files - Workspar 


These folders allow you to save a 


You can also drag and drop ‘Bar F 


Importing existing B 


The unit of deployment to the inte 
To import your Bar Files right-click 


Once done, you can then double. 
You can also drag and drop Bar Fi 


This will allow you to override the 
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5. Onthe Import Bar Files panel, click Browse and navigate to C:\student\webadmin\resources. 


Tick the check boxes for WLMSample_ProductSales.bar, WLM_hung_flow.bar, and 
WLM_notification_and_max_rate.bar. 





4 Import Bar Files 






File system 
Import resources from the local file system. 


From directory: | C:\student\webadmin\pesources 


WLMSample_ProductSales, bar 
=| WLM_hung_flow.bar 
=| WLM_notification_and_max_rate. bar 





LI |e [S3.) define_ web ae ey a 
C] [S.)set_webadmin_users MQauth. ond 





Fitter Types... | Select All | Deselect All_ | 
[inrneTwsee J Bowe. | 


Options 
[ Overwrite existing resources without warning 
[ Create complete folder structure 





Advanced >> 


@) 


[|_fiish | cancet_| 
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6. Your Bar Files folder should now contain the BARs we need to produce statistics later in the lab. 


dp IBM WebSphere MQ Explorer (Installation1) 
















El-€:3 IBM WebSphere MQ 
El Queue Managers 
Al iesqmer 

Fly) IBSOMGR2 


Bar Files - Workspar 


These folders allow you to save a 


a You can also drag and drop ‘Bar F 


=) Integration Nodes 
ee, default 
Bee WorkloadManagement 
, [ela Resource Managers 
(- Configurable Services 
oo LI Administration Queue 
dees 7 This will allow you to ide the 


Importing existing B 


The unit of deployment to the inte 
To import your Bar Files right-click 


Once done, you can then double. 
You can also drag and drop Bar Fi 
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7. Expand the Integration Nodes and IBQNODE. 


5. MQ Explorer -Navigator 23 e EY 78] 
FE} IBM WebSphere MQ 
El Queue Managers 
: = (= Queue Manager Clusters 


o> IMS Administered Objects 
: a (= Managed File Transfer 
wiealegervice Definition Repositories 
El-di Integration Nodes 
_ Eb-d§l IB9NODE 

ge, default 
_ —-¢e, WorkLoadManagement 
: F}~(8 Configurable Services 
|_| Administration Queue 






HGS GettingStarted 
El WLMSample 


bed (a WLMSample_ProductSales, bar 


If you do not see any Integration Servers under IBQNODE, right-click it and select Connect. 


Se Service Definition Repositories 
each SS 









New r |) 


Sas Bar Files 


Ge WLMStal 
fi] Start 
Stop b 


Retest 
2 Delete Integration Node 


[&] Export for remote connection... 
Modify Integration Node Tags... 
Select Queue Manager... 

“| Litems selected Export Port Configuration P 








If the WorkLoadManagement integration server is not started, right-click it and select Start. 
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8. Expand the WLMStats folder, right-click WLMSample_ProductSales.bar and select Deploy File. 


= NoeRe ARRAN OS) @ rate conn 2 


Be IBM WebSphere MQ Bape 
El Queue Managers 

Aa] IB9QMGR 

aii alana The bar itself is a compressed fi 

(=> Queue Manager Clusters 


~~ (> IMS Administered Objects Pes eer 


[=> Managed File Transfer 

--@ Service Definition Repositories 
Name 

Modification Time 

File Size 

Contents 


Flee Integration Nodes 
Ell IBSNODE 


Fal Configurable Services 
bse LI Administration Queue 


a-G GettingStarted 
Fl WLMStats 


2 (a WLM_hung_flow. bar 
(Ca WLM_notification_and_max_rate.bar Last Updated: 17:51:25 





On the Deploy Wizard, select IB9NODE — WorkLoadManagement (localhost) and click Finish. 


dp Deploy WLMSample_ProductSales.bar ; Se [oO] x| 





Deploy Wizard 
Select which integration server you wish to deploy to or double cick on a single integration server. 


Choose from the list below: 















A 
IBSNODE - WorkLoadManagement (localhost) 


@ cae _| 
The BAR is deployed to the WorkLoadManagement integration server. 
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9. Repeat step 8 for the other two barfiles. 


You now have running flows for exercising the Web UI and displaying message flow statistics later in the 
lab. 


10. In IB Explorer, specify the HTTP listener for the Web Admin UI. 


Right-click IB9NODE, and select Properties. 


dp IBM WebSphere MQ Explorer (Installation1) 









x Ts MQ Explorer - Content £2 
, + 
















[eh @ IBM WebSphere M : 
ii anion Integration Node IBS 
_ BS) iesqmer 
 -—E-Gl) IBsQMGR2 Gomection Quicken: 
oo ~~ Queue Manager Clusters : 
a & JMS Administered Objects — Status 
ia ~e — File Transfer Connection Type 
= \efinition Re Hostname 
Port 
Queue Manager 
: : 
cy 1 Bar Files Gonnect 
Disconnect 
Ag) Start 
Stop » 
Refresh F 
3 Delete Integration Node = 
Modify Integration Node Tags... 


Export Port aici 
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11. Select WebAdmin. The WebAdmin listener is already started by default, and has been set to the default 
port value of 4414 (registered with the IANA). You can leave all values unchanged. 


Click OK. 


#) IBSNODE - Properties 
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3. A first look at the Web Admin Interface (no security) 


1. Open a Firefox web browser by double-clicking the desktop icon. 


Click the provided shortcut link, Integration Bus Console (hitp://localhost:4414). 












”) Mozilla Firefox Start Page - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 


@ Mozilla Firefox Start Page [+| 


2. You will immediately note that you are logged in automatically, using the default user. 


Note that Admin Security is off. 
In this scenario, the default user has full update access to all deployed broker resources. 


If you have enabled the web admin http listener, and have defined web users, then you should fully enable 
security on systems that need such protection. 


°) IBM Integration - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 


| €9 IBM Integration L+| 


& localhost: 44 14/#broker/0 














Integration Bus Cons... | {_} WAS Admin Console (+ Worklight Console €:) Decision Center Enter... €) Rule Execution Serve... 


IBM Integration Welcome, Default ¥ 


7 Integration Node 





|= @ IB9NODE | 
+] g Servers 
+| ga8 Patterns IBSNODE 
+| RS] Policy 
+ ¢& Data 
+) && Security | ¥ Quick View 
+ Fj Monitoring 
+) FI) My Workspace 


Qoveview | Statistics 











running 
Short Description 
Long Description 








> Advanced Properties 
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3. In the Servers section, expand Servers by clicking on the plus sign. Expand the WorkloadManagement 


server (execution group) and any deployed applications. You should see the applications you just 
deployed in the previous step. 


") IBM Integration - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 


€°3 IBM Integration | + | 


& © localhost: 4414/Sbroker /0 


Integration Bus Cons... | |} WAS Admin Console (9 Worklight Console €:3 Decision Center Enter... 3) Rule Execution Serve... 


IBM Integration 








z Integration Node 
overview | pv Statistics 
=| ge Servers 


+ fe, default IBSNODE 
+) #s, WorkLoadManagement 





™ cas Patterns 





+| (RS) Policy * Quick View 
+) ge Data 
a Broker Name IBSNODE 
+| && Securit 
ac ly Version S000 
+ Monitoring 
= | Admin Security &) Off 
. Oo ee eoneer Run Mode running 
Short Description 


Long Description 


* Advanced Properties 
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4. You will see that you can Start and Stop the applications, as well as any defined server. 


Click on the WorkloadManagement server's context menu — down arrow beside the name - and select 
Stop. 


IBM Integration 


= z Integration Node - IB9SNODE 


a ios Q@ overview — | Statistics 
=| @& Servers 

+ ff, default 

- ¢=, WorkloadManagement ¥ 

(El Services f= WorkloadManagement 
=| (2) Applications * Quick View 
=| #&] WLMSample_Prod 
(= Libraries 


Broker Name IBSNODE 
| soe an Version 9000 
ap estes Statistics off Pee @ of 
alg WLMSample_ProductSales_ Producer 
Al WLMSample_ProductSales_Consumer 
= a] WLM_notification_and_max_rate 
= Libraries 
-| @f Resources 
als WLM_1 
-| &) WLM_hung_flow 
= Libraries 


-| @f Resources 


Run Mode running 
Short Description 


Long Description 


* Advanced Properties 


alg Account_management 
(= Libraries 


gi? Resources 
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5. Wait for it to show stopped (red down arrow). Notice that all the Applications and Resources are stopped. 


Select the context menu again and select Start. The server will start and show a green “up arrow”. 
IBM Integration 


Z q Integration Node - IB9SNODE 
@overiow || p suaistcs 
=| @& Servers 


+ cf, default 


- ¢ WorkloadManagement ¥ 
(a Seanices fz, WorkloadManagement 


=| (2) Applications * Quick View 
-| &] WLMSample_Prod 
(& Libraries Statistics on 
-| @& Resources Statistics off 
ala WLMSample_ProductSales_ Producer 
ala WLMSample_ProductSales_Consumer 
= oR] WLM_notification_and_max_rate 
= Libraries 
-| m® Resources 
a WLM_1 
-| &] WLM_hung_flow 
(= Libraries 


= ats Resources 


Broker Name IBSNODE 
Version 9000 
Admin Security €) off 
Run Mode running 
Short Description 


Long Description 


* Advanced Properties 


alg Account_management 
(= Libraries 


rats Resources 





6. Try stopping and starting an application or message flow in the same manner. 


IBM Integration 


ry a Data Flow 
id on ©) Overview ln Statistics R= Policies 
=| & Servers 
4] Gi default WLMSample_ProductSales_Consumer 
- ¢= WorkLoadManagement yw 
pel Services 
- g2l Applications * Quick View 
=) x] WLMSample_ProductSales ee 
-| @& Resources 
Alp WLMSample_ProductSales_ Producer 
Ala WLMSample_ProductSales Consumer BOE eee ise — 
+ #) WLM_notification_and_max_rate 
+| x] WLM_hung_flow 
(= Libraries 


f26c530b-3 f01-0000- 


Commit Count ‘| 


Additional Instances 0 
Start Mode Maintained 


Coordinated Transaction no 


(ae Resources 


a2 A+ Commit Interval : 
+) cae Pattemns 


+| (f=) Policy 
+ Data runMode running 


isRunning true 
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4. Configure role-based security for web users 


IBM Integration Bus provides the ability to control access to several broker functions through the web 
browser interface. This includes the ability to view and control the broker administration functions, as well 
as access to record/replay data, web pattern view and deployment, and policy settings. Different web 
users can have different access rights across these functions, and access can be granted, denied or 
revoked quickly. 


Role-based security is achieved by using the existing security functions provided in Integration Bus and 
WebSphere MQ. Authorities are set on the appropriate queue in the underlying queue manager. For 
example, authorities for the Record/Replay function are defined by using the 
SYSTEM.BROKER.DC.AUTH queue. 


The access authorities are defined against a set of user definitions which represent the available security 
roles. Each web user is then defined to use one or more of these security roles. For example, a Message 
Broker access definition might be made for a user called “RRView”. This user would have “view access” 
for the Record/Replay function, ie. it would have “ing” access for the SYSTEM.BROKER.DC.AUTH 
queue. The web user would then have a role access profile of “RRView”. 


For the purposes of this lab, the pre-built system has several user roles. These have already been 
defined to the Windows operating system, and are represented by the following userids: 


e ESBProfile1 (for Broker administration access, read-only) 
e ESBProfile2 (for Broker administration access, update functions) 
e ESBProfile3 (for Record/Replay users, not used in this lab) 


Note that although these users are regular Windows accounts, they have been removed from the 
Windows login screen, in order to avoid inadvertently logging in to Windows with these users. 
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4.1 Activate security for IBQNODE 


i? 


Page 19 


Open a Message Broker Command Console by double-clicking the desktop shortcut. 
Position the Firefox browser session with the Command Console window. 


Security can only be activated whilst the integration node is shutdown, so issue the following commands 


mqsistop IB9NODE 


When you issue the masistop, you will see the auto-refresh indicator turn red noting that the broker is not 
running. Hover over it and you will see a message indicating that “Real-time updates are disabled”. 





(cs.| Administrator: IBM Integration Console 9.0.0.0 Welcome, Default ¥ 


MQSI ?.6.6.6 
C:\IBM\M@GSIN\9 .6.6.6 






as Data Flow 
C:=\IBM\MQSIN? .@.6.@>mqsistop IB?NODE ae 


BIP8@71I: Successful command completion. .) Overview /w Statistics = Policies 
C=\IBM\MQSIN9 .6.8.8>_ 
WLMSample_ProductSales_Consumer 


Set security on with the following command: 


mqsichangebroker IBYNODE -s active 


Restart the broker with the following command: 


mqsistart IBYNODE 


After a short while, reload the browser page by clicking the indicator in the address page. 





= -{5) x! 


Welcome, Default ¥ i- 
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4. You are now presented with a sign-on screen since security has been activated. 


Before you can continue, we must configure security so you are able to sign in, so continue with the next 
step. 


ple ProductSales/messagefiows/WLMSample_ProductSales. ‘7 * Cc || Ea - Googl 


IBM Integration 


UserID: 


Password: 


Licensed Materials - Property of IBM Corp, Copyright by IBM Corp. and other{s} 2001, 2013. 
IBM, and the IBM logo are trademarks of International Business Machines Corporation, 
registered in many jurisdictions worldwide. Jawa and all Java-based marks and logos are 
trademarks or registered trademarks of Oracle and/or its affiliates, Other product or service 
names may be trademarks of IBM or other companies. Microsoft is a trademark of Microsoft 
Corporation in the United States, other countries, or both, 
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4.2 Define the MQ authorities for the web users 


1. Security for the Web Admin user interface is managed using MQ authorities. These MQ authorities are 
specified for the system usernames mentioned above (eg. ESBProfile1), which are then referenced by the 
Integration Bus web user definitions. 

The following table shows the MQ authorities that are required for different types of users: 


1) Web admin users (required for all users) 


MQ Object MQ Authority 
Queue Manager Connect, Inquire 
oY Oo LEM DEPLOY .QUEUE Put 
oY oO LEM, DEPLOY REPLY Get, Put 
SYSTEM. BROKER .AUTH imaKe| 
SYSTEM. BROKER.AUTH.execgroup Ing 


2) Web admin users (additional for update functions, eg. stop/start message flow) 


MQ Object MQ Authority 
SYSTEM. BROKER.AUTH ing, Patl,. Ser 
SYSTEM.BROKER.AUTH.execgroup Ing, Put, Set 


You will define the MQ Authorities for the following principals: 


ESBProfilel -—- web admin user, readonly 
ESBProfile2 - web admin user, update (start/stop) 


These definitions can be made through the IB Explorer (see the following paragraphs). However, the 
commands have been provided for you in a command file. In the command console, change directory to 
c:\student \ webadmin \ resources. 

Run the command: 


Set _webadmin users MQOAuth.cmd 


This will run several “setmqaut” commands to create the required authorities. You can examine these in 
more detail by editing the above command file. 
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4.3 Define the MQ authorities manually (optional) 
1. If you want to make the security definitions manually, in the MQ Explorer, expand the 
IB9QMGR queue manager, and select Queues. Ensure the Systems queues are displayed 
(you may need to click the “Show System Objects” button). 


Otherwise, skip straight to the next section, define the Web Users. 


> IBM WebSphere MQ Explorer (Installation1) a = {Oo} x} 


File Edit Window Help 








| 25. MQ Explorer - Naviga 53 ~ 
oe EY 
=] > 18m WebSphere MQ 
=) Queue Managers 
=|) MBsomer 
~~ Queues 
~~ Topics 
(> Subscriptions 
> Channels 




















4 Queuename | Queue type | Open input count | Open output count | Current queue depth | Put messe 4 | 


44 SYSTEM. BROKER. AUTH, WxSRequestEG Alias Allowed 
4 SYSTEM. BROKER. AUTH. WXSResponseEG Alias Allowed 









~~ (& Telemetry Gy SYSTEM.BROKER.CD.MODEL Model Allowed 
~~ Listeners lS) SYSTEM.BROKER.CONTROL.QUEUE Local 3 0 0 Allowed 





















































~~ Process Definitions |S) SYSTEM. BROKER.DC.BACKOUT Local 0 0 0 Allowed 

~~» aq MBSBROKER la) SYSTEM.BROKER.DC,RECORD Local 0 0 0 Allowed 

~~ Namelists ls) SYSTEM. BROKER.DEFAULT.STREAM Local 1 0 0 Allowed 

~~ Authentication Informat ls) SYSTEM.BROKER.DEPLOY.QUEUE Local 10 3 0 Allowed 

(> Communication Informa lS) SYSTEM.BROKER.DEPLOY.REPLY Local 3 0 0 Allowed 
AS) Qmar2 lS) SYSTEM. BROKER.EDA. COLLECTIONS Local 0 0 0 Allowed 
(> Queue Manager Clusters lS) SYSTEM.BROKER.EDA.EVENTS Local 0 0 0 Allowed 
~~ IMS Administered Objects lS) SYSTEM. BROKER .EXECUTIONGROUP. QUEUE Local 3 5 0 Allowed 
~~ Service Definition Repositories |S) SYSTEM. BROKER. EXECUTIONGROUP.REPLY Local 5 0 0 Allowed 
hats Brokers Cy SYSTEM.BROKER.FTE.MODEL Model Allowed 
od! BROKER2 |S] SYSTEM. BROKER. INTER. BROKER. COMMUNICATIONS Local 1 oO Oo Allowed 
=a ESCEROER: Gy SYSTEM.BROKER.MODEL. QUEUE Model Allowed 

+ i default (a) SYSTEM. BROKER. SEQ.EXPIRY Local O 0 0 Allowed 

oS Te WeSRequestEG [S| SYSTEM.BROKER.SEQ,GROUP Local 0 0 0 Allowed 

tHe WXSResponseEG ls) SYSTEM.BROKER.SEQ.NUMBER Local 0 0 0 Allowed 

#1 Configurable Services [S| SYSTEM. BROKER. TIMEOUT. QUEUE Local 0 0 0 Allowed 
Administration Queue lS] SYSTEM.BROKER. WS. ACK Local 0 0 0 Allowed 
€ Broker Archive Files la) SYSTEM. BROKER. WS. INPUT Local 0 0 0 Allowed 
lel CVCTEM ROOFED Wc DEDIY laeal n n n Allawsed 


2. Right-click the SYSTEM.BROKER.AUTH queue, and select Object Authorities, Manage 
Authority Records. 


6 Mo Explorer - Content £3 ~. Fl Resource Statistics Graph | FS MBSBROKER Resources Statistics (Snaps | VF MBSBROKER 4dn 





Queues 


fs Filter: Standard for Queues 


OIUeEUe name Rear Open inpuk count | Gpen qutpuk count | Current 


SYSTEM, BROERER, QUTH 
u Compare With,, 


= SYSTEM, BROKER, AUTH.c ae 
AUSYSTEM.BROKER.GUTH.Y Delete... Alias 
AUIS¥STEM.BROKER. AUTH.» Status... Alias 
Gy S¥STEM.BROKER.CO.MOl 0 Model 


Clear Messages... 


IS SYSTEM.BROKER.CONTR 9 Local 3 0 

(| SYSTEM. BROKER.DC.ALN a ee ‘ iia Local i 0 
TOMWSE PIESSaAQe5,., 

ls] SYSTEM.BROKER.DC.BAC 2 Local fl 0 

Create IMS Queue... ; _ - 


[ea] S'STEM, BROKER, DC, REC 
[eal S'STEM,. BROKER, DEFAUL 
[eal SYSTEM. BROKER. GEPLO' 


bed 1 rest ee see eee 







Find Accumulated Authorities... 
Manage Authority Records., 


Qbject Authorities 





Properties... 


Io oO oO oO oO oO 
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3. Expand “Specific Profiles”, and click SYSTEM.BROKER.AUTH. 


Select the Users tab. 


3 IBSQMGR - SYSTEM.BROKER.AUTH - Manage Authority Records 
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4. Ensure Users are selected, and click New. 
Set Entity name = ESBProfile1 
Set Inquire = ticked 


Click OK. 


| New Authorities 





Entity name: JeseProlel) 
Object type: fQueue sss 
Profile name: [SYSTEM.BROKER.AUTH ss 
Queue manager name: [IBSOMGR 


Authorities 
Administration Context 
. Change 
[” Clear 
[ Delete 
[ Display 









[ Pass all context 

[” Pass identity context 
[ Set all context 

[~ Set identity context 





Command preview 


setmqaut -m IBSQMGR. -n “SYSTEM. BROKER. AUTH" -t gq -p ESBProfile 1 +emove 
setmgaut -m IBSOMGER -n “SYSTEM. BROKER. ALITH™ -t g -p ESBProfile1 ting 
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5. The new user will be added. Note that this user will just have Inquire authority. 





6. Add another user, ESBProfile2. This user should have Ing, Put and Set authorities. 


TTT 
TTS ll 
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Note — the above optional section shows only a subset of the required permissions. If you 
wish to complete this task manually (using the MQ Explorer), you should ensure that the 
following MQ authorities are created. If you ran the script to create the MQ authorities, these 


will have been created for you. 


ESBProfile1 

Queue manager 

IB9QMGR 

Queues: 

SYSTEM.BROKER.AUTH 
SYSTEM.BROKER.AUTH.default 
SYSTEM.BROKER.AUTH.WorkloadManagement 
SYSTEM.BROKER.DEPLOY.QUEUE 
SYSTEM.BROKER.DEPLOY.REPLY 
SYSTEM.BROKER.WEBADMIN.SUBSCRIPTION 
Topic 

SYSTEM.BROKER.MB.TOPIC 


ESBProfile2 

Queue manager 

IB9QMGR 

Queues: 

SYSTEM.BROKER.AUTH 
SYSTEM.BROKER.AUTH.default 
SYSTEM.BROKER.AUTH.WorkloadManagement 
SYSTEM.BROKER.DEPLOY.QUEUE 
SYSTEM.BROKER.DEPLOY.REPLY 
SYSTEM.BROKER.WEBADMIN.SUBSCRIPTION 
Topic 

SYSTEM.BROKER.MB.TOPIC 
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+connect +ing 


+Inq 
+inq 
+ing 
+put 
+get +put 
+get +put 


+pub +Sub 


+connect +ing 


+ing +put +set 
+ing +put +set 
+ing +put +set 
+put 

+get +put 
+get +put 


+pub +Sub 
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4.4 Define the web users for IB9NODE 


1. Define an Integration Bus web user for read-only access. This user will be able to see what 
applications are deployed, but will not be able to control the status of these applications. 


In an Integration Bus Command Console, run the command 


mqsiwebuseradmin IBYNODE 


—u adminll 
-a passw0rd 
-r ESBProfilel 


This command will define a new web user, admin1. The user will have the security profile 
defined by the associated role, which in this case will mean that the user can only view the 
broker and any deployed applications. 


2. Define a Message Broker web user for update access. This user will be able to see what 
applications are deployed, and will be able to control the status of these applications 
(start/stop, etc). 


In a Message Broker Command Console, run the command 


mqsiwebuseradmin IBYNODE 
=¢ 
—u admin2 
-a passw0rd 
-r ESBProfile2 


This command will define a new web user, admin2. The user will have the security profile 
defined by the associated role, which in this case will mean that the user will be able to view 
the broker and execution groups, and any deployed applications, as well as control their 
status. 


3. Display the newly-defined web users by running the command 


mqsiwebuseradmin IBYNODE -1 


C:\student \RecordReplay\webadmin>mqsiwebuseradmin IB9NODE -1 

BIP28371I: Web user 'adminl' is defined as having a role of 'ESBProfilel'. 
BIP28371I: Web user 'admin2' is defined as having a role of 'ESBProfile2'. 
BIP80711I: Successful command completion. 


C2sstudent\webadminresources -mqsiwebuseradmin IT B?NODE —1 

BIPZSS 71: Web user ‘admini’ is defined as having a role of *ESBProfilei’. 
BIP2ZSS 71: Web user ‘admin2’ is defined as having a role of ’ESBProfile2’. 
BIPS@711:2 Successful command completion. 


CGC sstudent\webadmin\resources > 
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5. Using the Web Admin interface with security 
5.1 The web admin interface for a read-only user 


Now that security has been configured for Web Admin users, we will login as the admin1 user, which is 
read-only, and see what the browser interface offers for someone who can only view the Integration 


Node. 


1. Open anew Firefox web browser by clicking the plus (+) next to IBM Integration at the top of 
the browser window (above the URL). You should still have an open browser if you did not 
close it previously. You may use that one or open a new one. 


*) IBM Integration - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 


IBM Integration 














& localhost: 44:14/Sbroker /0 


Integration Bus Cons... | || WAS Admin Console (=) Worklight Console €:3 Decision Center E 





IBM Integration 


Z Integration Node 





= BORO . ” 7 
IBSNODE ©) Overview | Statistics 
=| = Servers 
+ fe, default ¥ IBDNODE 
+) oe, WorkLoadManagement 
- cas Patterns 





+| RS] Policy * Quick View 


+| ¢& Data 

+) $5 Security 

+| [a] Monitoring 

+| Fl My Workspace 
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Click the provided shortcut link, http://ocalhost:4414. 


”) Mozilla Firefox Start Page - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 
@ mozilla Firefox Start Page | -- | 


‘| WAS Admin Console (6 Worklight Console 


eel 


2. 




















This time, you will be presented with a login screen. Login with the userid admin1 (password 


is passwOrd). 


*) IBM Integration Bus - Mozilla Firefox 

File Edit View History Bookmarks Tools Help 

€:3 IBM Integration Bus i+ 
Ne 


| & | @ localhost: 4414 
€ Integration Bus Cons... |__| Decision Center {| WAS Admin Console (tj) Worklight Console 





IBM Integration 





ladmint 
Password: 
| [ELLE © e| _| 





Licensed Materials - Property of IBM Corp. Copyright by IBM Corp. and other{s): 

IBM, and the IBM loge are trademarks of International Business Machines Corpo 

registered in many jurisdictions worldwide, Java and all Java-based marks and lox 

—_—_—_—_— — trademarks or registered trademarks of Oracle and/or its affiliates. Other product 

= SS SS names may be trademarks of IBM or other companies. Microsoft is a trademark & 
Corporation in the United States, other countries, or both, 
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3. This user has read-only access to the node. 


Note that the Quick View will now show you that Admin Security is active. 


IBM Integration Welcome, admin1 





Qoverview — |v Statistics 





= IBSNODE 


+| = Servers 





+| a2 Patterns IBSNODE 

+| WS] Policy 

+| ¢= Data 

; ag Security * Quick View 

+) [ral é onitoring SoS IBSNODE 
+| Fil My Workspace Version: 5000 





Run Mode running 


Short Description 


Long Description 





* Advanced Properties 
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4. Expand the Servers category, and expand any deployed applications and services. The 


screen below shows several deployed applications. 


Note that clicking on any of the deployed applications in the navigator will show the details of 
the application. However, this user will not be able to start or stop the deployed applications, 
since the security profile is “read only”. You will not see any pull-down context menus as you 


did previously. 


IBM Integration 


Welcome, admint 





-| 4] IBSNODE 
=| = Servers 
+) ¢e, default 
| #, WorkloadManagement 
(el Services 
—| 74) Applications 
-| #&] WLMSample_ProductSales 
(= Libraries 
-| me Resources 
Als WLMSample_ProductSales Produce 
Alp WLMSample_ProductSales Consume 
+| #4] WLM_notification_and_max_rate 
+| &] WLM_hung_flow 
(& Libraries 
@e Resources 


+| ga Patterns 










+| f= Policy 

+| g2 Data 

+ ae Security 

+ Monitoring 

+| Pll My Workspace 
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Q Overview — rv Statistics 


WLMSample_ProductSales 


* Quick View 





Application Name 
Version 

Run Mode 

UUID 

Running 

Short Description 
Start Mode 


Long Description 





* Advanced Properties 





* Deployed Properties 


WLM 
runn 
afa 


true 


Main 
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5. Notice that although you are able to expand the policy folder and study existing policies you 
do not have permission to edit, create or delete policies. 


Expand the Data category (this is used for the Record/Replay data). You will see the Data 
Capture Stores heading, but no capture stores will be visible. This is because this user does 
not have access to any Record/Replay facilities (see the Record/Replay or Trades lab). 


IBM Integration 


=| 4] IBSNODE 
-| & Servers 
+| re, default 
-| =, WorkloadManagement 
pel Services 
-| (2) Applications 
+| &a] WLMSample_ProductSales 
+) &) WLM_notification_and_max_rate 
+) #4] WLM_hung_flow 
(= Libraries 
jae Resources 


ce# Patterns 


RS) Policy 
+| (ae Configurable Services 
+| #3 WorkloadManagement 
Ge Data 
| Data Capture Stores 
+| S& Security 
” Monitoring 
+) i My Workspace 
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5.2 The Web Admin interface for a user with update access 


Now that security has been configured for Web Admin users, we will login as the admin2 user which is 
the update user. This user has full functionality for stopping and starting resources and for creating and 


deleting policies. 
1. After exploring the facilities for admin1, logout admin1. 


Click the pull-down beside the Welcome, admin1 banner and select Log Out. 


Welcome, admini ¥ 










Edit Profile 


. Log Out 


QO Overview |. Statistics 





IBSNODE 


* Quick View 





me 


Oo ee eee ees 


Log-in as admin2 (password is passwOrd). 





IBM Integration 
User ID: 

admin? 

Password: 

Cre YT «| 





Licensed Materials - Property of IBM Corp. Copyright by IBM Corp. and other{s} 2001, 2013. 
IBM, and the IBM loge are trademarks of International Business Machines Corporation, 
registered in many jurisdictions worldwide, Jawa and all Java-based marks and logos are 
trademarks or registered trademarks of Oracle and/or its affiliates. Other product or service 
—— names may be trademarks of IBM or other companies. Microsoft is a trademark of Microsoft 
= Corperation in the United States, other countries, or both. 
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2. As before, expand the deployed applications. You will see that this user has the ability to Start and Stop 
the deployed applications, by clicking on the arrow on the right of the item in the navigator. 


Click on the WLMSample_ProductSales application. Then click on the pull-down to the right of the 
application and select Stop. 


IBM Integration 





- oNoDd ; 
IBSNODE ©) Overview nw Statistics 
=| = Servers 
+) @ default WLMSample_ProductSales 
-| @, WorkloadManagement 
(e Services 












+| #4) WLMSample_ProductSales 
+| &&) WLM_notification_and_max_ra {| WLMSample_ProductSales 


+| #4) WLM_hung_flow 


(& Libraries Stop 
ae Resources Statistics on 
+) @88 Patterns Statistics off 
: ero i ption 
+| fis) Policy 
Start Mode 
+| ¢& Data 
foil Paces, Long Description 
The application will stop. 
Restart the WLM_ProductSales application. 
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3. Expand the Monitoring item, and click Admin Log. All broker log messages will be displayed. The most 
recent Change Notification item will be the restart of the application. 


To see the message detail of the message, hover over the latest Change Notification under the Source 
column. It will change to a hot link. Click on it and the message will be expanded to show the full text. 
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Admin Log 


© Overview 


Message 


BIP287 11 
BIP287 11 


BIP28801 


BIP287 11 
BIP287 11 
BIP28801 
BIP287 11 
BIP287 11 
BIP28801 


BIP287 11 


BIP287 11 


Source 


Administration Request 


Administration Request 


Administration Result 


Administration Request 


Change Notification 


Administration Result 


Administration Request 


Change Notification 


Administration Result 


Administration Request 


Timestamp 


2013-06-05 11:34:48.851 


2013-06-05 11:34:47.333 


2013-06-05 
11:34:34.570 GMT 
Standard Time 


2013-06-05 11:34:34.479 


2013-06-05 11:34:34,235 


2013-06-05 11:34:02.131 


2013-06-05 11:34:02.031 


2013-06-05 11:33:54.476 


2013-06-05 11:33:45.365 


2013-06-05 11:33:45.250 


2013-06-05 11:33:44.966 
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v& Refresh 


Message Detail 


The request made by user ‘SYSTEM[Defaulff to ‘create’ the resource WorkloadManage = 
The request made by user ‘SYSTEM[Defaulff to ‘create’ the resource WorkloadManage 


The property ‘objectrunstate’ has changed from ‘stopped to ‘running’ on object 
WLMSample_ProductSales’ of type ‘Application’ with parent WorkloadManagement 
of type ‘ExecutionGroup’. 


The request made by user ‘SYSTEM[Defaulff to ‘start the resource WLMSample_Prodt 
The request made by user ‘SYSTEM[Defaulff to ‘starf the resource WLMSample_Prodt 
The property ‘object.runstate’ has changed from ‘running’ to ‘stopped’ on object WLMSz 
The request made by user ‘SYSTEM[Defaulff to ‘stop’ the resource WLMSample_Prodt 
The request made by user ‘SYSTEM[Defaulff to ‘stop’ the resource WLMSample_Prodt 
The property ‘object.runstate’ has changed from ‘stopped to ‘running’ on object WLMS 


The request made by user ‘SYSTEM[Defaulff to ‘start the resource *WLMSample_Prod 


The request made by user ‘SYSTEM[Defaulff to ‘start the resource ‘WLMSample_Prod hd] 
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6. Exploring the Web Admin flow statistics facilities 
6.1 Investigate the statistics function in the web admin interface 
1. Earlier in the lab, you deployed the barfiles for the applications we will use to generate statistics. Check 


the IB Explorer to make sure the applications and message flows are running in the 
WorkloadManagement integration server. 


=] = 5 ain Nodes 


E a ne Ge ceed 
El) WLM_hung_flow 
: I- a WLM_notification_and_max_rate 
: Sa ale WLM_1 
_ --fegil WLM_1_Compute.esal 
| = a WLMSample_ProductSales 
7 ~~ IE] WLMSample_ProductSales_Consumer 
i fA] WLMSample_ProductSales_Producer 
a ki Resource Managers 
3 eh - Configurable Services 
> fe = Administration Queue 


El Bar Files 
HG GettingStarted 





2. Return to the Web Browser admin tool, and click the IBQNODE node. 


We looked at the Quick View earlier when discussing security. Scroll down to see the Advanced 
Properties where you will find information about the platform which the node Is running on as well as the 
queue manager name supporting the node. 


* Advanced Properties 


Platform Name Windows ? Enterprise 
Fixpack Capability unrestricted 

Operation Mode advanced 

Platform Architecture pt a] 

Platform Version 6.1 build 7601 Service Pack 1 


Queue Manager IBSQMGR 


Build Level $000-L130531 
Admin Agent Process ID SoS 
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As before, expand the servers and deployed applications. As you expand the sub-folders, the navigator 


(vertical sliding bar) should automatically adjust, but you may need to adjust the viewable area by 


grabbing and sliding the navigator to your liking. 


rs 
ETault 
orkLoadManagement 
1 Services 
. Applications 
&s| WLMSample_ProductSdles 
(= Libraries 
-| @& Resources 
Ala WLMSample_Prqducts: 
ag WLMSample_Prqducts; 
&| WLM_notification_and_mi 
fe] WLM_hung_flow 
a Libraries 
Bp Resources 


ns 


4. Click on the Statistics tab. 


IBM Integration 





= Z Integration Node 


@ Overview | Statistics 


IBSNODE 


* Quick View 


Broker Name 
Version 

Admin Security 
Run Mode 

Short Description 


Long Description 


* Advanced Properties 


Welcome, Default ¥ 


-| 4] IBSNODE 


-| = Servers 
+) ee, default 
- #=, WorkloadManagement 
pe) Services 
-| (2) Applications 
+| #4) WLMSample_ProductSales 
= Fa] WLM_ notification and _max_rate 
(& Libraries 
+| @& Resources 
+| a) WLM_hung_flow 
(& Libraries 
ge Resources 
+) 28 Patterns 
+| ff] Policy 


QO) Overview | / Statistics 


IE9NODE - Summary 


* Throughput by Flows for last 0 seconds 


Flow name 


ala WLMSample_ProductSales_ Producer 
(Stavsics off) 

ala WLM Sample_ProductSales Consumer 
(Starsics off) 

ala WLM_1 (Stavstics off) 

ala Account_management (Statistics off) 





You will see the flows that are deployed to all integration servers. You should not see any flow statistics 


yet because we have not sent any data to the flows 
Statistics on for any of the flows. 
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5. — If not fully expanded, expand the two categories — “Throughput by Flows for last seconds” and “Nodes for 
all flows in IB9NODE”. 
IBM Integration Welcome, Default ¥ 
| =< ONO | QO Ooverview _— | Statistics 
=| @ Servers 
+) & default IB9NODE - Summary 
-| ge, WorkloadManagement 
(&) Services “4 
=| 2) Applications ¥ Throughput by Flows for last 0 seconds 
+ &] WLMSample_ProductSales ini © Average Elap 
= &) WLM_notification_and_max_rate Flow name (messagesis) Time! — 
& a ple ProductSales_Producer 
+ gi Resources 
+| 5) WLM_hung_flow = Wor = Bre_ProductSales_Consumer 
am (Statistics off, 
& ee WLM_1 (Statistics off) 
@S Resources Account_management (Statistics off) 
+) g28 Patterns 
+| (5 Policy — 
+) ¢& Data 
+] 38 Security 
+ Monitoring 
+ al My Workspace 
ba 
You can see that statistics are off for the flows. Scroll to the right or adjust the navigator to observe the 
columns indicating statistics which statistics will be captured. 
6. Click on the WorkloadManagement server. You are taken to the Overview panel for the 
WorkloadManagement integration server. 
IBM Integration Welcome, Default ¥ 
=| 4 IBINODE lv Statistics 
=| & Servers 
+] @& default WorkloadManagement 
=| (2) Applications | * Quick View 
+| #] WLMSample_ProductSales : 
Execution Group Name WorkloadManagement 
= eal WLM_notification_and_max_rate . 
Run Mode running 
(= Libraries 
ave f-3.f01-0000-00¢ : rescse 
- UID 6a9e360 f-3701-0000-0060-9b5d0763c3cb 
= Resource: 
= ap Running true 
ina Short Description 
+| #4) WLM_hung_flow SEIS 
= Libraries Long Description 
(a Resources 
iad — F Adwanced Pronertias 
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7. The Quick View is expanded for you. You may collapse it if you are not interested in the general 
information. Expand Advanced Properties also. 


IBM Integration Welcome, Default ¥ 





Eeecd 
“= Integration Server 


ssi aie Qoverview | Statistics 
=| = Servers 
+ @ default WorkloadManagement 






-— #, WorkloadManagement vw 





-| (2) Applications 
+| #4) WLMSample_Product 


Execution Group Name WorkloadManagement 
-| #4) WLM_notification_and. 
Run Mode running 
= Libraries 
UUID 6a9e360f-3101-0000-0080-9b5d0763c3cb 
= Resources 
aa wika 1 Running true 
ra Short Description 
+| #&) WLM_hung_flow 
‘ Long Description 
= Libraries 


@ Resources 


+ cas Patterns 





dvanced Properties 


+| 5] Policy 
+ fees] Data Process ID 5308 
+) 8% Security Trace Level none 
+ [Ra] Monitoring Soap Nodes use Embedded ue 
Listener 
+| Fl My Workspace 
Console Mode off 


The Quick View panel displays important information about the execution group such as its name, UUID, 
Run Mode. If necessary, scroll down to see the Advanced Properties. 


Advanced Properties show more detailed information such as Process ID, Trace Level, and exits. 
Review the Quick View and Advanced Properties. 
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8. Click Statistics. Expand the groups if they are collapsed. At the Server level, you will only see the flows 
running in that particular server. Again, note that Statistics are currently off for the flows. 


,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,  ——————————————————————————————————— 
a 
“= Integration Server - WorkloadManagement 


a Overview 





summary 





* Throughput by Flows for last 0 seconds 


aa eonaen Average Elapsed 
ane Message Rate ¥ et eee 
Flow name (messagesis) Time! aaa 


als WLMSample_ProductSales Producer 


(Statistics off) 

oa WLLMSample ProductSales_ Consumer 
(Statsics off) 

als WLM_1 (Statistics off) 

ala Account_management (Statistics off) 





9. Expand Applications and click WLMSample_ProductSales. Again you see a Quick View which gives you 
the application name, UUID, and status. 


IBM Integration Welcome, Default Vv 





[Al Application - WLMSample_ProductSales 
- & IB9NODE 


© Overview |v Statistics 
=| @ Servers 


+ im default 


= im WorkloadManagement 























Services aa 
& | ¥ Quick View 
- ga Applications 
«| FX] WLMSample_ProductSales ~ | Application Name WLMSample_ProductSales 
+) &)] WLM_notification_and_max_rate  ~ Version 
x WLM h fl Run Mode running 
+ _hung_flow w+ 
UUID a3d85f33-3f01-0000-0080-d5b3853e95bd 
(& Libraries ps = 
nning ue 
Resources 
8 p & Short Description 
+ g¢s8 Patterns 
& : Start Mode Maintained 
+| RS Policy 
Long Description 
+| Data 
+| 48 Security 
— [As] Monitorin 
9 | vy Advanced Properties 
F Admin Log 
+| FF) My Workspace Default .NET Application Domain 
Trace Node Level on 
Service Trace | evel none 
Page 40 Web administration Version 9.0.0.0.1 


Provided by IBM BetaWorks 


IBM Integration Bus V9.0 Workshop 


September 2013 


10. Expand Advanced Properties and Deployed Properties. Review the information found here. 





Application - WLMSample_ProductsSales 


O Overview jn Statistics 


UUID 
Running 

al Short Description 
Start Mode 


Long Description 


* Advanced Properties 





Default .NWET Application Domain 
Trace Node Level 
Service Trace Level 


User Trace Level 





* Deployed Properties 
Modified time 
Deployed time 


Bar file name 


a3dé5f32-3701-0000-0060-d5b3-65¢e95bd 


true 


Maintained 


on 
nome 


none 


2013-05-09 14:54:56.000 +0100 
2013-06-12 13:32:52.633 +0100 


CAUsers\ibadminviibhwWwrebSpherehMOiworkspace-instal 
VWVLI Sample _ProductSales. bar 


Advanced properties show which traces are on and the default .NET application domain if there is one. 
Deployed Properties show the barfile name, modified time and date, and the deployed time and date. 


Page 41 Web administration 
Provided by IBM BetaWorks 


Version 9.0.0.0.1 


IBM Integration Bus V9.0 Workshop September 2013 


11. Click Statistics. Now you will only see the message flows for the application WLMSample_ProductSales. 
Again observe that the statistics are off. 


[Al Application - WLMSample_ProductSales 


* Throughput by Flows for last 0 seconds 


Average Eli 


Message Rate ¥ Time! Invor 


Flow name (messages/s) 


ala WLMSample_ProductSales Producer 


AG WLMSample_ProductSales_Consumer 
(Statistics off) 





12. Expand the WLMSample_ProductSales application and its Resources where you find the message flows 
of the application. 


IBM Integration Welcome, Default ¥ 





aS Data Flow - WLMSample_ProductSales_ Producer 


=| AJ IBINODE Qoverview [Statistics  R5)Policies 
=| & Severs 
ate im default + 


-| ee, WorkloadManagement w 








pl Services ae 
* Quick View 
~ gal Applications 
- AN WLMSample_ProductSales -+ Message Flow Name WLMSample_ProductSales_Producer 
B Libraries version 
UUID 6tdeST33-3101-0000-0080-d5bs853e95bd 
[MSample_ProductSales Producer + Commit Count 1 
Service Trace Level none 
AG WLMSample_ProductSales Consumer + 
Additional Instances 0 
+ Fa] WLM_notification_and_max_rate mins 
Start Mode Maintained 
* @s] WLM_hung_flow + Coordinated Transaction no 
= Libraries Commit Interval 0 
@e Resources isRunning true 
OG , uu : 
+] gue Patterns runMlode running 
+) (S| Policy 
+) ¢& Data 





+) 88 Security 


—| ES Maniterina 


* Advanced Properties 
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13. Click on WLMSample_ProductSales_Producer. The Quick View shows the common properties of the 
message flow. The flow should be running. 


IBM Integration Welcome, Default ¥ 


af Data Flow - WLMSample_ProductSales_ Producer 


a) a Be Qoverview Statistics ——«R5] Policies 
=| g Servers 
+| 7p, default + 
-| ee, WorkloadManagement + 
c&l Services 
~ gal Applications 


* Quick View 


-| &] WLMSample_ProductSales 9 -~ WLMSample_ProductSales_ Producer 
(& Libraries 
— ae Resources 6ideS 33-3 101 -0000-0080-d5b3355e95bd 
ag WLMSample_ProductSales_Producer » Perel 
AG WLMSample_ProductSales Consumer + See 
+ A WLM_notification_and_max_rate + a. Maintained 
+) fs] WLM_hung_ flow ~ Coordinated Transaction no 
(= Libraries Commit Interval 0 
@e Resources isRunning true 
+ cee Patterns runMlode running 
+) ff Policy 
+) (2 Data 
+) 4 Security * Advanced Properties 


—| BS Manitarina 





Expand Advanced Properties and Deployed Properties and observe the trace information and deployment 
information about the flow. 


aS Data Flow - WLMSample_ProductSales_Producer 


© Overview bw Statistics R= Policies 





»¥ Quick View 





Message Flow Name WLMSample_ProductSales_Producer 
version 

UUID 6fdeSf33-3f01-0000-0080-d5b3353e9Sbd 
Commit Count 

Service Trace Level 

Additional Instances 

Start Mode 

Coordinated Transaction 

Commit Interval 

isRunning 


runMode 





y~ Advanced Properties 





User Trace Level 





» Deployed Properties 





Modified time 2013-05-09 14:54:56.000 +0100 
Deployed time 2013-06-12 13:32:52.633 +0100 





= = CMisers\ibadminViRM\WiebhSohereM O\worksnace-installatinn1\Wi I 
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14. Click Statistics. We know statistics are still off and here you see a warning message that they are turned 


off. 


This is the lowest level to turn on statistics. If you only want statistics produced for a particular flow, you 
need turn on statistics for that flow. If you want statistics for all the flows in an application, you can turn on 
Statistics for the application, and statistics will be collected for all the flows in the application. Likewise you 
can turn statistics on at the integration server level and all flows in all applications running in the execution 
group will be collected. And it can be extended up to the integration node level for all flows in the broker. 
When we do the exercise later in the lab, we will turn on statistics for an application that has two flows 


running. 


A |BONODE 
(= Servers 
+) ge default 
~ ge, WorkloadManagement 
(& Services 
- (a Applications 
- &\] WLMSample_ProductSales 
(& Libraries 


- of Resources 








aly WLMSample_ProductSales_Producer 





ag WLMSample_ProductSales_Consumer 
+) &] WLM_notification_and_max_rate  w 
+) &) WLM_hung_flow w 
(& Libraries 
@® Resources 
+) #8 Patterns 
+) RS Policy 
+| ¢& Data 
r a Security 
Monitoring 


©) Overview Statistics  &5Policies 


Flow analysis 








Y No data available, statistics are disabled or the data flow is not running. 


Time range:| Session + 








Message Rate (messages/s) ~* 


Latest 

Average 
Highest 
Lowest 


Average Elapsed Time/Invoc;  * 


Latest 

Average 
Highest 
Lowest 





Hover over the message and you will see it is a hyperlink. Click on it and you will see more details about 


the message if they are available. 


4. Statistics collect 


ion for the flow is turmmed off 


There is no message flow deployed. Deploy a flow and turn the statistics on. 


* Session data 





Close the detail popup by clicking the X in the top right corner. 
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15. Inthe Web Admin UI, each flow has an area for three graphs to be displayed. The graphs to be shown are 
determined by the value shown in the title bar of the box. Each box defaults to a particular measurement. 
You see Message Rate in the first, Average Elapsed Time per Invocation for the second, and Average 
CPU Time per Invocation for the third. An invocation is the start of a message flow at an input node. It can 


be an MQInput node, a Filelnput, or any other. 


Each box has a pull-down which will show you all measurements which are available. 


Fe ala Data Flow - WLMSample ProductSales Producer 


a) A EEE QOveniew ‘|r Statistics 5] Policies 
=| @ Servers 


+ @ default w Flow analysis 
- fe, WorkloadManagement 
(& Services 
~ es Applications 
- A] WLMSample_ProductSales 


¥ No data available, statistics are disabled or the data flow is not running. Time range:| Session + 


(> Libraries Message Rate (messages/s} + 
~ Resources 
a 3 Latest 
ag WLMSample_ProductSales_ Producer Average 


ag WLMSample_ProductSales_Consumer Highest 


+) &s| WLN_notification_and_max_rate Lowest 


+) i) WLM_hung_flow + 


(& Libraries 

af Resources Average Elapsed Time/Invoc: = * 
+) gil Patterns Latest 
Average 
Highest 
Lowest 


+] (fz Policy 

+) 2 Data 

+| #3 Security 

-| Fal Monitoring 
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16. Click on the pull-down for the Message Rate box. 


Message Rate (messages/s) 
Message Rate (messages/s) 
Average Elapsed Time/ Invocation (ms) 


Average CPU Time/ Invocation (ms) 


Total CPU Time Waiting for Input Message (ms) 


Total Elapsed Time Waiting for Input Message (ms) 
Maximum CPU Time (ms) 

Maximum Elapsed Time (ms) 

Maximum Size of Input Messages (Kb) 

Minimum CPU Time (ms) 

Minimum Elapsed Time (ms) 

Minimum Size of Input Messages (Kb) 

Number of Threads in Pool 

Times Maximum Number of Threads Reached 
Total CPU Time (ms) 


Total Elapsed Time (ms) 





The pull-down for each box is the same, so the graphs can be configured to display the measurements 
you are interested in and in what order. 


17. In addition, when the flows are running the Latest, Average, Highest and Lowest of the measurement you 
are graphing will change dynamically as messages are processed. They will change every twenty seconds 
as that is the snapshot time for displaying the values. 


a Data Flow - WLMSample_ProductSales_Producer 
@ Overview hv Statistics R= Policies 


Flow analysis 





| ¥ No data available, statistics are disabled or the data flow is not running. Time range:| Session + 





Message Rate (messages/s)}) ~¥ 


Latest 
Average 
Highest 
Lowest 


Average ElapsedTime/invoc: ~¥ 





Latest 


18. Scroll down until you see the Flow Profile category. It should be already expanded. The Flow Profile 
shows you what nodes are in the flow and how they are connected. There are no details such as node 
properties, but it gives the administrator an idea of the “flow of the flow” when monitoring statistics. 
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19. Inthe web admin navigator, expand Policy. 


Policies are new in IIB V9. Policies can be defined for Configurable Services and for message flows to 
control Workload Management properties. Once policies are defined, they can be attached to the 


message flow to control message rates and time-out processing of the flow. Policies are stored in the 
Integration Node Registry. 


IBM Integration 


= IBSNODE 


+| = Servers 


oo , 
“go ane 


orate Services 
+| 5 WorkloadManagement 
+| gi Data 
+) $5 Security 
+) [fs] Monitoring 
+| Fl My Workspace 





20. Expand WorkloadManagement. There are no sub-folders, but you find a drop-down context menu. 


=] 4] IBINODE 
+| = Servers 
+| gaa Patterns 
=| 5) Policy 


+| (ae Configurable Services 


@ WorkloadManagement ¥ P Maccans 
z Data >> WorkloadManagement 


+| 9% Security ee 
+| [as] Monitoring 


@) BiP28711 
+| Fl My Workspace 





Since there are no policies yet defined, you can only create a policy. Once policies exist, you will be able 
to select a policy and attach it to a flow. 


You will do that exercise in the next section. 
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6.2 Using the Web Admin interface to show running flow statistics 


Now that you have seen what the Web Admin interface looks like, you will now run some message flows, 
so that you can view the statistics of running applications and flows. 


1. Open three DOS command prompt windows by double-clicking the icon on the desktop. 


In each command prompt window, navigate to 
C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_makx. 


2. You will run one of three programs in each of the command windows: 
e producer of messages — produces messages as fast as possible 


¢ consumer of message — can only consume messages at 100 messages / second 
e listener for notification messages — will subscribe to topic string where notifications are published 


Select one window and run the consumer program by entering the following command: 


run wim _con.bat 


=juy x] 


Microsoft Windows [Version 6.1.76611] 


Copyright ¢c)> 2669 Microsoft Corporation. All rights reserved. 





C:\UsersN\iibadmin>cd \student\Workload_Management\Resources\WLMdemo\WLM_not_and 
max 


C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max)run_wlm_con. bat M ge rate (m Se ond) 


C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max>set PATH="C:\Pr 
ogram Files ¢x86>\IBM\IntegrationToolkit?@\jdk\bin";C:\IBM\WebSphere MQ\java\lib 
3C:\Windows\s ystem32 5C:\Windows 5C:\Windows\system32\whem;C:\Windows\s ystem32\win 
dows powershell\vi1.@\3;c-\program files\ibm\gsk8\1ib;C:\IBM\SQLLIB\BIN;C:\IBM\SQLL 
IB\FUNCTION;C:\IBM\SQLLIB\SAMPLES\REPL;C:\IBM\WebSphere MQ\bin;C:\IBM\WebS phere 
NQ@\tools\c\samples\bin;C:\IBM\Integrat ionToolkit?@\jdk\bin;C:\Program Files\Micr 
osoft SQL Server\116\Tools\Binn\;C:\Program Files\cuysnt;C:\Program Files\I BM\Mob 
ility Client\; 


Gs Dag em lt eg Management\resources\WLMdemo\WLM_ not_and_max> java -cp “wlm_d 
-\swt.japjsorg.swtchart 4. 8 .6.uv26126361. jarsorg.swtchart .ext_@.8.6.u2 
: ip3C:\IBM\SQLLIB\java\dh2 jcc - jar;C:\IBM\ 100 
SQLLIBNjava\sqlj.zip;C: NIBMNSQLLIB\java\db2 jcc_ license_cu.jar;5C: NI BMNS @QLLI BNbin ; 
C:\IBM\SQLLIB\java\common. jar;C:\I BM\WebS phere MQ\ java\lib\con. ibm.mqjms .jar;C:\ 
IBM\WebS phere MOQ\ java\ Lib\com. ibm.mq. jar" Rate_consumer 





The application starts up and starts receiving messages on the queue WLM.OUT1 which is the output 
queue of MQOUTPUT node in the flow which is processing the messages. A running bar graph is 
displayed showing the message rate at which it is receiving messages. It will send error messages to alert 
operators that the messages are coming faster than it can handle. 
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3. 
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In another window, start the listener by typing in the following command: 


run wlm list.bat 
















52 Comim 210) 10x 
23/05/2613 Fun_wim_prod. bat a | 


38/85/2813 Snap.20138534.171538 5756 .G083 .tre Message flow name 


34/85/2013 Snap.261360530.184359687.976 .6683 tre # ——— 
13/66/2011 swt .jar : 
6566/2613 wiln.mgsc 
BS 46/2813 wilm_demo_app. jar 
15/05/2613 WLA_not_max_pi.zip 
16 File‘s> 4.169.926 bytes 
3 °Dir¢s> 22,284,242.944 hytes free 





iC=\studentWorkload_Management*resources*iLAdemo*VLA_not_and_max?run_wilm_list .ba 


iC=\student\Workload_Management*resources*WLMAdemo*VLA_not_and_max?set PATH="C:\Pr 
iogram Files ¢x86>\TBM\Integrat ionToolLkit?#\jdk\bin";C:\.1 BM WebSphere MQ\javas\lib 
;GC:\Windows’s ystem325C=\Windows 5C=\Windows’s ystems 2 whem; C= \Windows’s ystems2s\win 
dows povershell vi .@\3c2%program files*\ibm.qsk8*\1ib;C:*\1 BN\SQLLIB\XBIN;C:\1IBN\.SGQLL 
1 BNFUNCT ION; C:\I BMNSQLLI BNSAMPLES\REPL;C:\1 BM\WebS phere NQ*bin;C:\1TBM\Webs phere 
MNQ\tools\c\samples*bin;C:\1 BMI ntegrat ionToolkit?@jdk*\bin;C:\Program Files*Micr 
osoft 8QL Server.116\Tools*\Binn’\;C:\Program Files*\cusnt;¢:\Program Files*\IBM\Mob 
ility Client’; 


G:\student\Wlorkload_Management \resources\WLMdemoSWLM_not_and_max?javaw -cp “wim 
demo_app.jar;swt.jarjorg.sutchart_4.8.4.u28120381. jariorg.swtchart -ext_4.8.8.u28 
126361 .jar;C: ST BASS@LLI BN javasdbe java.zipsC:\1BMSSQLLIB\javasdb2 jcc. jar;C:\1 BMS 
QLLIBNjava’sq1lj-2ip;¢:\IBN\SQLLI EB java.db2 jcec_license_cu.jar;C:\I BM\SQ@LLIB\bin;¢ 
ESD BASSQLLIESjavascommon.jarsC:SITBASWebSphere MQ\javas\libscom.ibm.mgjms .jar;C¢:s] 
BM WebSphere MQ\javaslib\com.ibm.mg.jar” Rate_listener 


| ———EEEE 





The listener application starts another pop-up window which shows alarms received by the subscription. 
The application will change the color from green to red if the message rate is too high. 


In the third window, start the producer program with the following command: 


run_wlm_prod.bat 





oo stra -/0) X) ee cectee -|Oj x] 
WLM.IN1 

C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max>set PATH="C:\Pr 

ogram Files ¢(x86>\IBM\IntegrationToolkit?@\jdk\bin"; "C:\Program Files ¢x86>\IBM\ 

Integrat ionToo Lkit?@\jdk\bin";C:\IBM\WebSphere MQ\java\1lib;C:\Windows\system3253C Message rate (messages per second) 


=\Windows 5C:\Windows\s ystem32\whem;C:\Windows\s ystem32\windows powershe l1l\v1 .@\5c 200 
=<\program files\ibm\gsk8\1ib;C:\IBM\SQLLIB\BIN;C:\IBM\SQLLI B\FUNCTION;C:\I BM\SQL 
LIB\SAMPLES\REPL;3C:\IBM\WebS phere MQNbin;C:\IBM\WebSphere MQ\tools\c\samples\bin 
>;C:\IBMN\Integrat ionToolkit?@\jdk\bin;C:\Program Files\Microsoft SQL Server\i1@NT 
ools\Binn\;C:\Program Files\cusnt;C:\Program Files\IBM\Mobility Client\; 


C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max>java —-cp “wlm_d 
emo_app.jar;.\swt.japjorg.swtchart_@.8 .@.v26126361.jarjorg.swtchart .ext_@.8.@.u2 150 


6126361. jar;C:\IBM\SQLLIB\ java\db2 java.zip;C:\IBM\SQLLI BN javaN\db2 jcc. jar;C:\IBM\ 
SQLLIB\javaN\sq1lj-zip;C:\IBM\SQLLIB\ java\db2 jcc_license_cu. jar;C:\IBM\SQLLIBNbin; 
C:\IBM\SQLLIB\java\common. jar;C:\IBM\WebSphere MQ\java\lib\com.ibm.mqjms.jar5;C=\ 
IBM\WebS phere MQ\java\lib\com.ibm.mq.jar’ Rate_producer 
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You should now see messages being sent by the producer application and being received by the consumer 
application. The producer application is putting messages on to the WLM.IN1 queue which is the queue for 
MQINPUT node of the message flow we will monitor — WLM_1, in the WLM_notification_and max_rate 
application. 





app =/O) x} 
Queue name 
WLM.IN1 WLM.OUT1 
ae Message rate (messages per second) em Message rate (messages per second) 
Message flow name 
150 150 - = =—t—<“iOS—~—CS 


Alarm 


100 100 
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Expand the Servers, WorkloadManagement, Applications, and WLM_notification_and_max_rate, and 


Resources. 


IBM Integration 


-| & IBSNODE 


El 
=| Servers 


*| ge, default 
-| ¢¢, WorkloadManagement 
(& Services 
- (& Applications 


September 2013 


+) A) WLMSample_ProductSales 


-| A\) WL_notification_and_max_rate 


(B Libraries 
~| i Resources 
+] &X) WLM_hung_flow 
Libraries 
af Resources 
+) gi Patterns 
+) 5 Policy 
+) E Data 
+) a8 Security 
+ [Al Monitoring 
+) PUL My Workspace 





Click the pull-down for the application WLM_notification_and_max_rate. 


Select “Statistics on”. 


IBM Integration 


-| 4] IB9NODE 
-| & Servers 
+ ge, default 
ge, WorkloadManagement 
cg) Services 
-| G2) Applications 
+| &] WLMSample_ProductSales 


Message 








~ &) WLM_notification_and_max_rate 


| = 





@& Libraries 
- gi Resources 
aj WLM_1 
+| &] WLM_hung_flow 
@& Libraries 


=o 
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WLM_notification_and_max_rate 


top 


Statistics on 


Statistics off 
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7. You will receive a message that statistics have been turned on. We turned them on at the application level, 
So Statistics for all the flows in the application would be collected. However there is only one flow in this 
application. We could have just as easily selected the resource WLM_1 and turned on statistics. 


| © Flow statistics successfully turned on 


=| & IBINODE Q Overview _—/ Statistics 


ao 
=| @& Servers 


*| ge, default Summary 


=| g@, WorkloadManagement 





¢& Services 
ex Applications 





Y Throughput per message flow for last 20 seconds. Last updated at 14:18:10 GMT Standard Time. 





Flow name atin mht sa a 
(messages/s) 


@& Libraries a (ms) 
-| g@ Resources WLM_1 “"\ 0.00 0.0 0.0 


= ea WLMSample_ProductSales Average CPU Time! 


Invocation (ms) 


AG WLMSample_ProductSales_Producer 


ag WLMSample_ProductSales_Consumer 





+ | WLM_notification_and_max_rate ~ 
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Click WLM_1. The snapshot interval is twenty seconds, so you will need to wait until the first snapshot has 


September 2013 


collected the statistics for the period. You will then see the graphs being created. 


The time of day is displayed at the bottom of the graph on the x-axis and an appropriate value for the 
measurement being graphed will be displayed on the left of the graph on the y-axis. Inside the box on the 
right of the graph you will see the Latest, High, Average, and Low values for the period. 


The graphs are being displayed dynamically, so you can monitor them for a few minutes to see the 


changes over time. 


af Data Flow - WLM_1 


Q Overview |v Statistics R) Policies 


Detail 


Message Rate (messages/s) 
100 


2:25 PM 


Average Elapsed Time/ Invocation (ms) 


Message Rate (messages/s) ~* 


Latest 

Average 
Highest 
Lowest 


64.10 
72.40 
85.30 
57.60 


Average Elapsed Time/invoc; ~ 


Latest 

Average 
Highest 
Lowest 





2:25 PM 


Average CPU Time? Invocation (ms) 











0.4 
0.4 
0.5 
0.4 


Average CPU Time/Invocatio. ~ 


Latest 

Average 
Highest 
Lowest 





0.1 
0.1 
0.1 
0.1 
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9. Scroll down to the next category “Latest data per node”. Here you will see all the nodes in the flow and the 
Average CPU Time in milliseconds and Average Elapsed Time in milliseconds. These are the average 
times which messages spend being processed in that time. 


An administrator can easily see the costly nodes of each flow. As mentioned the Flow profile is the last 
category displayed. Looking at the nodes in message flow WLM_1, we can see that the time is evenly 
distributed between all nodes. That’s because it is a very simple flow for demo purposes. The Compute is 
doing nothing but passing the message through. 


aS Data Flow - WLM_1 


OD Overview |ow Statistics RS Policies 
Detail 


“oo PM 270 PM 
Average Elapsed Time! Invocation (ms) 
Average Elapsed Time Invoc: ag 


Latest o4 
Average o.4 
Highest 0O.5 
Lowest o.4 


ah PM 276 PM 2:27 PM 230 PM 


Average CPU Time! Invocation (ms) 
0.075 
0.073 
0.04 Latest 

0.008 Average 
0.005 Highest 
0.003 Lowest 

o 


Average CPU Time’ Invocatiol 


2:27 PM 220 PM 


* Latest data per node Minimum |Average |Maximum 


Average Elapsed ¥ #£Average CPU Time 

Time (ms) ims) | Mode type 
Compute o.2 0.1 ComputeMode 
Mm Output O.2 0.4 MQOutputhode 
Ml Input 0.1 0.1 MQinputtiode 


Node 





10. Click WLM_notification_and_max_rate application in the navigator. 


IBM Integration 


-| 4 IBINODE 
=| & Sewers 
+ ge, default 
~ #3, WorkloadManagement 
(& Services 
-| (2) Applications 
+| &) WLMSample_ProductSales 


zs Fa WLM_notification_and_max_rate ¥ 


mo Resources 
al WLM_1 
+) #4) WLM_hung_flow 





Click the Statistics tab for this flow. 
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11. Wait for the twenty second interval to pass. You will see all the flows which are running in the this 
application (only WLM_1). 
You may need to scroll to the right or adjust the navigator bar to see all of the columns. Notice the title of 
the columns. They are the measurements you saw in the pull-down menu for the graphs earlier. 


[Al Application - WLM_notification_and_max_rate 


Summary 





| Y Throughput per message flow for last 20 seconds. Last updated on Wed Jun 05 2013 12:25:29 GMT+0100 (GMT Standard Time). 





Average Elapsed 
Time! Invocation 

(ms) 
a wom1& 68.20 0.4 0.1 1364 1 0 = worktoadMan: 


Message Rate V 
(messages/s) 


Average CPU Time/ Total Input Active 


Invocation (ms) Messages Threads Backouts | Container 


Flow name 


Se 


| Y Nodes for all flows in WLM_notification_and_max_rate 








Node Average CPU Time Average Elapsed Total Elapsed Total CPU Time 
) 


Time (ms) Time (ms) 
Compute : ; . : 1364 ComputeNode 
MQ Input ; ; : i 1364 MQInputNode 
MQ Output : 3 : . 1364 MQOutputNode 


Invocations Node type 





12. After the twenty second interval, you will see a small magnifying glass next to the flow name. Click the 
magnifying glass icon and the detailed graphs will be displayed for that flow. 


wi4 Data Flow - WLM_1 


overview ‘|v Statistics R5 Policies 


Detail 


Message Rate (messages/s) 


Message Rate (messages/s) ~¥ 
60 
Latest 60.90 
40 Average 61.72 
Highest 72.30 
Lowest 54.80 








2:33:57 PM 2:34:03PM 2:34:09PM 2:3415PM 2:34:21PM 2:34:27PM 2:34:33PM 2:34:39PM 2:34:45PM 2:34:51PM 2:34:57 PM 
2:34:00 PM 2:34:06 PM 9 2:34:12PM 2:34:18PM 2:34:24PM 2:34:30PM 2:34:36 PM 2:34:42PM 2:34:48PM 2:34:54 PM 


Average Elapsed Time/ Invocation (ms) 
Average ElapsedTime/Invoc; ~* 


Latest 0.4 
Average 
Highest 
Lowest 


2:33:57 PM 2:34:03PM 2:34:09PM 2:34:15PM 2:34:21PM 2:34:27PM 2:34:33PM 2:34:39PM 2:34:45PM 2:34:51PM 2:34:57 PM 
2:34:00 PM 2:34:06 PM 2:34:12PM 2:3418PM 2:34:24PM 2:34:30PM 2:34:36PM 2:34:42PM 2:34:48PM 2:34:54 PM 


Average CPU Time? Invocation (ms) 


Average CPU Time! Invocatio1 


Latest 0.1 
Average 
Highest 
9 | Lowest 
2 33:57 PM 2:34:003PM 2:34:009PM 2:34:15PM 2:34:21PM 2:34:27PM 2:34:33PM 2:34:39PM 2:34:45PM 2:34:51PM 2:34:57 PM 
2:334:00PM 2:34:06PM 2:3412PM 2:34:18PM 2:34:24PM 2:34:30PM 2:34:36PM 2:34:42PM 2:34:48PM 2:34:54PM 
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13. As mentioned earlier, you can do the same at the Integration Server and Integration Node levels. 
Remember, once statistics are set on for the flow, you do not need to do it at the higher levels. 
Manipulating statistics at the higher level, sets them on or off for all flows within that container. 
Try that now. 


Click WLMSample_ProductSales to bring it into view. Set statistics on for the application. 


IBM Integration 


=) J IBSNODE 


-| = Servers 


+) ge, default 
-| &, WorkloadManagement 
(=) Services 
(él Applications * Quick View 
ay +| #4] WLMSample_ProductSales ¥ 
+) &§] WLM_notification_and_max_rat £3] WLMSample_ProductSales 
+| a) WLM_hung_flow 
(& Libraries 
@e Resources 


WLMSample_Produs 


running 
174ece13-3701-000 


true 





Click the Statistics tab. 


14. Send data to the flows. 
In an Integration Console 9.0 session, navigate to C:\student\webadmin\run\Run_slow_tcpip app. Enter 
the command s/low_tcpip_app. 


This application simulates a slow back-end application that is being flooded by messages from the 
integration bus. You will slow down the message rate sent to this application by creating a policy in the 
integration bus, and applying it to the particular integration application. 
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15. Ina Windows Explorer window, navigate to C:\student\webadmin\data. Right click the 
WLMSample_QueryProductSalesByStores.xml file and select Copy. (This file contains a large number of 
records). 






r RecordReplay 
|) Service_creation 
r Service_discovery 
|). Subflows 


|) WESB_Conversion 
r Workload Management 


Ls 


Navigate to C:\WLMSample and paste this file onto the fileinput directory. 


. WLMSample 








Organize * (]/Open Indudeinlibrary ~  Sharewith + New folder 
kt RecordReplay = 
r Service _creation 
r Service_discovery 


r WESB_ Conversion 
r Workload Management 
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16. Return to the browser window and wait for the screen to refresh. You will now see the statistics displayed 
for both flows in the application. 


[Al Application - WLMSample_ProductSales 


Q Overview _—‘ Statistics 


Summary 





Y Throughput per message flow for last 20 seconds. Last updated on Wed Jun 05 2013 13:50:13 GMT+0100 (GMT Standard Time). 











Average Elapsed 
Time! Invocation 
(ms) 

39.67 17.2 1.3 
423.10 1.6 0.1 


Total Input 
Messages 


Average CPU Time/ 
Invocation (ms) 


Message Rate V 


Flow name (messages/s) 


833 
8462 


aa WLMSample_ProductSales_Consumer ® 
ag WLMSample_ProductSales_Producer aS 


SSS 


Active 
Threads 


4 
j 


Backouts Container 


0 al WorkloadManag 
0 a WorkloadManag 





Y Nodes for all flows in WLMSample_ProductSales 











Total Elapsed Total CPU Time 
Time (ms) (ms) 
13,155.7 1,053.1 


1,116.1 12 


meray Average CPU Time Average Elapsed 

(ms) Time (ms) 
Append response to Output file 15.8 1.3 
Receive response from TCPIP backend 14 0.1 
Ignore end of file message 0.0 . 0.0 0.0 


Read Sales records from XML data file 0.2 1,614.6 28.2 
Send to TCPIP backend 1.4 11,463.7 330.1 


invocations 


833 
833 


0 


8462 
8462 


Node type 


FileOutputNode 
TCPIPClientinputNode 
WLMSample_ProductSales_Produc 
er#FCMComposite_1_4 
FilelnputNode 
TCPIPClientOutputNode 





17. Click the WLMSample_ProductSales_ Consumer flow to see the detail graphs for the flow. 
This application will run quickly, so you may see a declining rate like this. If you are too late, just rerun the 
application by copying the data file again and pasting into the C:\WLMSample\fileinput directory. 


a Data Flow - WLMSample_ProductSales_Producer 


© Overview jv Statistics R= Policies 


Detail 


Message Rate (messages/s) 


Message Rate (messages/s} ~ 





2:52:12 PM 2:52:24 PM 2:52:36 PM 
52:06 PM 2:52:18 PM 2:52:30 PM 


2:51:48 PM 2:52:00 PM 
2:51:54 PM 


0 
2:51:36 PM 
2:51:42 PM 


Average Elapsed Time? Invocation (ms) 


Latest 
Average 
Highest 
Lowest 


0.00 
24.42 
170.89 
0.00 


Average ElapsedTime/Invoc ~ 





2:52:24 PM 2:52:36 PM 


2:52:30 PM 


2:52:00 PM 2:52:12 PM 
2:52:06 PM 2:52:18 PM 


2:51:48 PM 


2:51:36 PM 


2:51:42 PM 2:51:54 PM 


Average CPU Time?’ Invocation (ms) 


Latest 
Average 
Highest 
Lowest 


0.0 
0.6 
4.1 
0.0 


Average CPU Time/ Invocation ~ 





2:51:36 PM 
2-51:49 PM 


2:51:48 PM 


2:52:00 PM 2:52:12 PM 
2-51-54 PM 2 


2:52:06 PM 
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Latest 
Average 
Highest 
Lowest 


0.0 
0.1 
0.1 
0.0 
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6.3 Create and use a policy to limit flow throughput 


1. Expand Policy. Click the pull-down arrow for WorkloadManagement and select Create. 
+| gaa Patterns 
=| (5) Policy 
+| (a Configurable Services 


(#2 WorkloadManagement ¥ 7" 
> WorkloadManagement 


+ Ge Data 
5 Secu 


zt Monitoring 
+| Fl My Workspace 





2. The WorkloadManagement properties are displayed. 


zg | Policies 


@ Overview 


WorkloadManagement [Ek] Save 


Policy Name 


* Targets and Limits 


Notification Threshold 
messages per second 
Maximum Rate 


messages per second 


* Additional Instances 


Additional Instances 


Start additional instances when flow starts 


Start Mode 


* Transactionality 


Commit Count 


Commit Interval 





Jf. Cancel 


Notice that they are divided into four groups (scroll down to see all four); Targets and Limits, Additional 
Instances, Transactionality, and Unresponsive Message Flows. Review the groups and properties. This is 
the way in which the WebAdmin UI presents the properties, in logical groups. The IB Toolkit only lists the 


properties in the message flow editor. 


You can collapse Additional Instances and Transactionality as we will only create policies for Targets and 


Limits and Unresponsive Message Flows. 
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3. In Policy Name, type WLMAlert. Set the value for Notification Threshold to 65. Also set the maximum 
message rate to 100. 


Le Policies 


© Overview 
WorkloadManagement [Save / Cancel 


. 


Policy Name WLMAlert 





| ¥ Targets and Limits 





Notification Threshold essages per second 


Maximum Rate essages per second 





¥ Additional Instances 





Additional Instances 


Start additional instances when flow starts 





Click Save (this may take a few seconds to save and refresh the navigator). 


4. You will get a confirmation that the policy was successfully created. 


© Successfully created policy 14:39 PM 


© Overview 
WLMAlert (Save < Cancel 


~ 


Policy Name WLMAlert 





| ¥ Targets and Limits 








Notification Threshold messages per second 


Maximum Rate ' messages per second 





Y Additional Instances 








You will see the new policy WLMAlert under the Policy > WorkloadManagement folder. 


=| (| Policy 
+) ( Configurable Services 


=| #3 WorkloadManagement 
8S WLMAlert 
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5. Create another policy. Click on the WorkloadManagement pull-down and select Create. Name this policy 


WLMMaxRate. 


Set the Maximum Rate to 10. 


Le Policies 


WorkloadManagement 


Policy Name WLMMaxRate 


* Targets and Limits 


Notification Threshald 


Maximum Rate 


* Additional Instances 


Additional Instances 





messages per second 


messages per second 


Click Save and wait for the success message. (this may take a few seconds to save and refresh the 


navigator) 
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6. Create one more policy called WLMTimeOut. Collapse all the groups except Unresponsive Message 


Flows. 


September 2013 


Click the pull-down for Processing timeout action and select “Restart execution group”. 
Type in 15 for the Processing timeout. 


This policy will not be used during this lab but is highlighted to show that a policy can be used to control the 
unresponsive behaviour of a message flow. For more information with regards to unresponsive flows 
please see the lab guide 'WorkloadManagement Unresponsive Flows’. 


g _| Policies 


© Overview 


WorkloadManagement 


Click Save and wait for the success message. (this may take a few seconds to save and refresh the 


navigator) 


Policy Name WLMTimeOut 








¥ Targets and Limits 








Notification Threshold 
messages per second 
Maximum Rate 


messages per second 








> Additional Instances 











Start Mode 





> Transactionality 








¥ Unresponsive Message Fiqws 











Processing timeout action 


Processing timeout 


seconds 


Restart executionfigroup 





7. You now have three policies. 
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+| g24 Patterns 
=| fis Policy 
+) Le Configurable Services 
=| #2 WorkloadManagement 
R=) WLMMaxRate 
R=) WLMTimeOut w 


#5 WLMAlert 
p= Data 
&® Security 
Monitoring 
+| FP] My Workspace 
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8. Click the WLMSample_ProductSales_ Produce message flow under WMSample_ProductSales > 
Resources. 


=| & IBYNODE 9 Overview )w Statistics 
- @& Servers 


— WLMSample_ProductSales_Producer 
-| ge, WorkloadManagement 





-E] Services - 
& ¥ Policies 





- 2) Applications 
&&) WLMSample_ProductSales 


Available policies 


No attached policy 
gZ@ Resources 


aj WLMSample_ProductSales_Producer v 
AG WLMSample_ProductSales_Consumer 





WLMMaxRate 





WLMAlert 
WLMTimeOut 
+) &\) WLM_hung_flow 
@& Libraries 





The WLMSample_ProductSales Consumer message flow can only handle ten messages per second. So 
we need to throttle the WLMSample_ProductSales Consumer flow to only send ten messages per second. 
We now have a policy, WLMMaxRate, that specifies a maximum message rate of ten messages per 
second. 

To accomplish this, we can attach WLMMaxRate policy to the WLMSample_ProductSales_ Producer 
message flow. 

Click the radio button for WLMMaxRate. Then click Apply. 


© Overview lv Statistics R= Policies 


WLMSample_ProductSales_Producer Ea 2 Cancel 


| ¥ Policies 








Available policies 


WLMTimeOut 





You will receive a completion message. (This may take a few seconds) 


© Successfully attached policy 
@ Overview w Statistics @5| Policies 


WLMSample_ProductSales_Producer 


* Policies 


Available policies 


Mo attached policy 
WLM MaxRate 
WLM Alert 
WLMTimeOut 
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9. Repeat steps 15 and 16, from the previous section, to rerun the WLMSample_ProductSales application. 


Bring the Slow TCPIP application monitor into view and observe that the message rate never exceeds ten 
messages per second which is what the policy WLMMaxRate enforces. 


Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Message 
Command A Message 
Prompt ODM Message 


wa ED BAD Ya DY aD EY DY DT Dw Tw DT A 





If you didn't notice, there was no re-deploy of the application necessary to put the policy into effect. All that 
was needed was for the administrator to attach the policy to the message flow and the WebAdmin tool 
dynamically enforces the policy on the flow by automatically doing the redeploy. 


10. Now attach the WLMAlert policy,click apply to the WLM_1 message flow in the 
WLM_ notification. and_max_rate application. 


wi Data Flow - WLM_1 


—— 2 Overview Vv Statistics 
¢& Servers 


+) ge default WLM_1 2 Apply 
é WorkloadManagement 
(i Services 


| ¥ Policies 





-| 2) Applications 
&) WLMSample_ProductSales 
@®& Libraries 
@e Resources 
ag WLMSample_ProductSales_Producer 
a WLMSample ProductSales Consumer 


WLM TimeOut 
aN WLM_notification_and_max_rate gre 


= Libraries 


Available policies 
No attached policy 
WLMMaxRate 
WLMMAlert 





4 {} = 
| AGWLM_1 vy 





@& Libraries 
@® Resources 





Don't forget to click Apply. You will receive a completion message. 'Successfully attached policy’. (This may 
take a few seconds) 
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11. Bring the WLM Alarm, Sending application, and Receiving application windows into focus and observe the 
effect of the policy. 








= = = Ssage rate o | 
(Sending application 15) x) =|) x} 
Queue name Queue name 
| WLM.IN1 | WLM.OUT1 


Message rate (messages per second) Message rate (messages per second) 


200 200 


100 100 





Monitor the WLM Alarm window for a few minutes. You should see it change from green to red to green as 
the message rate goes above and below the sixty-five messages per second rate defined in the WLMAlert 
policy. You should see the effect of the message rate on the Receiving application immediately. The graph 
has smoothed out and is under 100 messages per second. Again, the policy only needed to be attached to 
the flow, IIB WebAdmin did the rest. 


12. Return to the web browser session and see if you can correlate what you have observed with the statistics 
in the WebAdmin. 


Obviously, we want to look at the message rate WLM_1. It should be that the flow is definitely producing 
messages well under the rate of one hundred set in the policy. You can also see the its high was over 
seventy and thus the red alarm. 


af Data Flow - WLM_1 - WLMSample_ProductSales_ Producer 


Q Overview [vStatistics  &5 Policies 


Detail 





| Y Session started 16:43:40 GMT Standard Time (2 minutes ago). Last updated at 16:45:39 GMT Standard Time Time range:| Session + 





Message Rate (messages/s) 


Latest 67.85 
40 Average 64.76 
Highest 72.37 
Lowest 57.60 





4:44:00 PM 4:44:24PM 4:44:48 PM 4:45:12 PM 4:45:36 PM 
4:44:12PM 4:44:36 PM 4:45:00PM 4:45:24 PM 
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13. Click the WLMSample_ProductSales_ Producer flow. We should not see the rate go above ten. 
This screen shot was taken as the application started sending messages, so you can see the rate gearing 
up from zero to just under ten which is exactly what the WorkloadManagement policy was intended to do. If 
you completed the WorkloadManagement Throughput Control lab, you know this application sent 
messages as fast as it could, over three hundred messages per second, without any throttling. 


af Data Flow - WLMSample_ProductSales_Producer 


© Overview )w Statistics R= Policies 


Detail 








Y Session started 17:10:19 GMT Standard Time (2 minutes ago). Last updated at 17:12:20 GMT Standard Time Time range:| Session + 





Message Rate (messages/s) 
Message Rate (messages/s) ~* 


Latest 9.45 
Average 4.60 
Highest 9.50 
Lowest 7.10 





; 5:10:42 PM 5:10:54 PM 5:11:06 PM 5:11:18 PM 5:11:30 PM 5:11:42 PM 5:11:54 PM 5:12:06 PM 5:12:18 PM 
5:10:48 PM 5:11:00 PM §:11:12 PM 5:11:24 PM 5:11:36 PM 5:11:48 PM 5:12:00 PM §:12:12 PM 


Average Elapsed Time? Invocation (ms) 
Average Elapsed Time/Invoc; ~¥ 


Latest 1.8 
Average 11 
Highest 

Lowest 





5:10:42 PM 5:10:54 PM 5:11:06 PM 5:11:18 PM 5:11:30 PM 5:11:42 PM 5:11:54 PM 5:12:06 PM 5:12:18 PM 
5:10:48 PM 5:11:00 PM §:11:12 PM 5:11:24 PM 5:11:36 PM 5:11:48 PM 5:12:00 PM 5:12:12 PM 


Average CPU Time? Invocation (ms) 
Average CPU Time? Invocatiol 


Latest 0.1 
Average 0.1 
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14. Have a look at the consumer flow also before you close the windows. Since this is the back-end 
application, we would not attach a policy here (unless it may be producing messages for another 
application). This is the application we are protecting with a WorkloadManagement policy and the fastest it 
can process messages Is ten per second. It appears the application should be happy, because it is 
processing just under ten messages per second. 


ale Data Flow - WLMSample_ProductSales_Consumer 


> Overview /w Statistics R= Policies 


Detail 





| Y Session started 17:12:20 GMT Standard Time (1 minute ago). Last updated at 17:13:00 GMT Standard Time Time range:| Session ~ 





Message Rate (messages/s) 
Message Rate (messages/s} a 


Latest 9.45 
Average 9.25 
Highest 9.45 
i i Lowest 8.95 
5:12:40 PM 5:12:44 PM 5:12:48 PM 5:12:52 PM 5:12:56 PM 5:13:00 PM 
5:12:42 PM 5:12:46 PM 5:12:50 PM 5:12:54 PM 5:12:58 PM 
Average Elapsed Time? Invocation (ms) 
Average Elapsed Time?’ Invoc; 


Latest 
Average 
Highest 
a | | | | | | ! I | | Lowest 
5:12:40 PM 5:12:44 PM 5:12:48 PM i Vo 5:12:56 PM 5:13:00 PM 
5:12:42 PM 5:12:46 PM 5 5:12:58 PM 
Average CPU Time’ Invocation (ms) 
Average CPU Time?’ Invocatio 


Latest 
Average 
Highest 
Lowest 





This concludes the Web Admin lab. You can see that the Web Admin browser interface is a very friendly 
and functional tool for IIB administrators. Message flows can be monitored and policies can be configured 
and attached to those flows to control workload for backend applications. 
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